home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / maths / agp / !AGPDoc / TextDoc < prev   
Encoding:
Text File  |  1995-11-28  |  12.9 KB  |  359 lines
  1. Introduction
  2.  
  3. AGP, the Archimedes Graph Plotter, is a WIMP-based program to plot
  4. graphs of functions (for example y=sin(x)).  It can plot up to two
  5. graphs on the same axes and allows control over the range of the axes
  6. and the colours of the graphs.  If you are not familiar with RISC OS,
  7. you may find it useful to refer to pages 3-16 and 68-73 of the RISC OS
  8. User Guide (Issue 1) before using AGP.
  9.  
  10. Further Help
  11.  
  12. AGP has a help system provided by Ben Summers' HelpReader system.  This
  13. provides similar information to that in this guide.  It also provides
  14. help to !Help and similar systems.
  15.  
  16. Starting & Stopping
  17.  
  18. To start AGP, double-click on its icon in a directory display.  Its icon
  19. will appear on the icon bar.  Clicking Select on this icon opens two
  20. windows: the main AGP window and the Controls window.  To quit AGP,
  21. click Menu over the AGP icon and choose Quit from the menu.
  22.  
  23. Functions
  24.  
  25. AGP expects its functions to be in a format acceptable to BASIC.  For
  26. those of you who don't understand how BASIC expressions work, they are
  27. in the normal algebraic format, although division is expressed by /,
  28. multiplication by * and raising to powers by ^.  AGP performs some
  29. pre-processing, so you can enter the function in lower case and use ¹
  30. (Alt+1), ² (Alt+2) and ³ (Alt+3) instead of ^1 (not that you'd want to
  31. use this), ^2 and ^3.  AGP now supports implied multiplication, so you
  32. can enter 2x for 2*x.  You can also use × and ÷ for * and /.  If there
  33. are any errors in the expression, you will be informed and it will not
  34. be plotted.
  35.  
  36. The Controls Window
  37.  
  38. When the AGP icon on the icon bar is clicked on, in addition to the main
  39. Graph window, a small pane opens on the side of it.  This is the
  40. Controls window.  It provides a convenient way to access some of AGP's
  41. options.  Anything that can be done from this window can also be done
  42. via AGP's menu structure.  The functions used by AGP to plot its graphs
  43. are shown in the two writeable icons at the top of the window.  The
  44. plotting of the graphs is controlled by the button to the left of each
  45. function.  When a button is depressed, that function will be plotted. 
  46. The colours used to plot the graphs are shown in two boxes in the bottom
  47. left-hand corner of the window.  To change these colours, click Menu on
  48. the arrow to the right of the colour you wish to change.  This will open
  49. a colour dialogue box (See pages 70-71 of the RISC OS User Guide (Issue
  50. 1)).  To the left of these, the current co-ordinates of the pointer
  51. within the Graph window are shown.  At the for left of the window are
  52. the zoom icons.  See below for more details.
  53.  
  54. Graph Re-sizing
  55.  
  56. There is a small icon in the bottom right-hand corner of the graph
  57. window.  Dragging this with Select will cause the size of the graph
  58. within the window to change.  This is useful if you have a cluttered
  59. desktop and don’t have room to fill it with a huge graph.  The icon
  60. always stays in the corner of the work area of the window, so you may
  61. have to scroll the window to find it.
  62.  
  63. The Icon Bar Menu
  64.  
  65. This menu is called up by clicking Menu on AGP’s icon on the icon bar. 
  66. The Info option leads to a standard RISC OS Info box, which provides
  67. information about AGP and a nice little scrolltext.  The Help option
  68. loads a help text, using Ben Summers' HelpReader system.  This will
  69. automatically move itself to relate to what is being done with AGP.  The
  70. Quit option causes AGP to quit.
  71.  
  72. The Graph Menu
  73.  
  74. This menu is called up by clicking Menu in the AGP Graph window.  This
  75. allows control over the graph.  All of the options in this menu lead to
  76. sub-menus, so they are described under other headings below.
  77.  
  78. The Save Menu
  79.  
  80. This menu, accessed via the Save option in the Graph menu, allows you to
  81. save the graph via standard RISC OS save dialogue boxes.  The formats
  82. available are:
  83.  
  84. Graph           AGP’s own format  (for re-loading into AGP).
  85.  
  86. DrawFile        The Draw format (For importing into DTP packages,
  87.                 drawing packages etc.).
  88.  
  89. The use of these dialogue boxes is explained on page 47 of the RISC OS
  90. User Guide (Issue 1).
  91.  
  92. The Settings Menu
  93.  
  94. This menu is accessed from the Settings option of the Graph menu.  It
  95. allows you to alter settings which apply to the whole of the graph.  The
  96. Range option leads to the Range dialogue box (described below).  The
  97. Zoom in and Zoom out options engage or disengage zoom in or zoom out
  98. mode respectively.  In zoom in mode, it is possible to drag a box around
  99. an area which will then be expanded to fill the window.  The zoom out
  100. option works in the opposite way, with the window's contents shrinking
  101. to fit the box.  These options can also be controlled using the relevant
  102. icons in the Controls window.  The Size option leads to a box which
  103. allows you to alter the size of the graph, as with the Re-size Graph
  104. icon.  The values can be entered in centimetres or inches, the units
  105. being used are specified with the radio buttons.  The Grid option turns
  106. on and off a grid behind the graph.  You will probably be unable to see
  107. this in two-colour modes.  The Angles option leads to the Angles menu,
  108. from which you can choose whether trigonometric functions use Degrees or
  109. Radians.  Grads are not yet supported, and, unless someone asks for it,
  110. they are unlikely to ever be.
  111.  
  112. The Range Dialogue Box
  113.  
  114. This box allows you to change the range of the x and y axes of the
  115. graph.  You must enter a maximum and a minimum value for each.
  116.  
  117. The Function Menu
  118.  
  119. This menu allows you to change various aspects of a function and the way
  120. it is plotted.  The Plot option controls whether or not the function
  121. will be plotted.  The Colour option leads to a standard RISC OS colour
  122. selector.  Instructions on using this are on pages 70-71 of the RISC OS
  123. User Guide (Issue 1).  The Resolution option leads to a menu which
  124. allows you to change how many points AGP samples in order to plot the
  125. graph.  High resolution is accurate but slow, while Low resolution is
  126. fast but inaccurate.  Of course, if you've got an ARM 3, you haven't got
  127. any problems.
  128.  
  129. Re-plotting
  130.  
  131. Many actions within AGP cause the graph to be re-plotted.  Especially
  132. when using complex functions or a high resolution, this can take a long
  133. time.  If you are changing many options at the same time, you can hold
  134. down Shift to prevent the graph being re-plotted until you change the
  135. last option.
  136.  
  137. The Print Dialogue Box
  138.  
  139. This dialogue box is accessed via the Print entry on the Graph menu. 
  140. This option is 'greyed out' if there is no printer driver installed. 
  141. This option allows you to print out the current graph through a standard
  142. RISC OS printer driver.  You can type the number of copies in the Copies
  143. field and the scaling to be applied to the graph before printing in the
  144. Scaling fields.  For example 2:1 means double size.  The radio buttons
  145. below these allow you to choose whether the graph is plotted in Portrait
  146. (upright) or Landscape (sideways) mode.  The Margins fields hold the
  147. distance from the bottom left-hand corner of the paper at which the
  148. graph will be printed in the units specified by the radio buttons below. 
  149. These treat the bottom left-hand corner of the paper as being that near
  150. to the bottom left-hand corner of the graph.  To centre the graph on the
  151. paper, click on the Centre button.  This should be done after setting
  152. all of the other options, to ensure correct positioning.  Click on the
  153. Print button to start printing.  Printing can be stopped by pressing
  154. Escape.
  155.  
  156. The Controls Menu
  157.  
  158. This menu allows control over the positioning of the Controls window. 
  159. It is accessed via the Controls option in the Graph menu.  The Linked
  160. option links the Controls window to the side of the graph window.  The
  161. Loose option detaches it and allows it to move independently.  Finally,
  162. the Off option removes the Controls window from the desktop entirely.
  163.  
  164. File Handling
  165.  
  166. AGP uses file type &124.  If this clashes with another program’s file
  167. type, please write to me, so that I can change it.
  168.  
  169. AGP supports in-RAM transfer with co-operating applications such as
  170. Draw.  It can also use the simpler Wimp$Scrap protocol with
  171. applications, like DrawPlus, which don't support in-RAM transfer.
  172.  
  173. The file format used by AGP changes fairly frequently, although each
  174. version of AGP can load files created by previous versions.  This means,
  175. however, that one version of AGP may not be able to load a file
  176. generated by a newer one.  If you want details of the file format,
  177. please write to me.
  178.  
  179. When it starts up, AGP loads the file ‘!AGP.Default’ automatically. 
  180. This file can be altered if you want different settings on start up.
  181.  
  182. Viruses
  183.  
  184. When it left my hands, AGP was not infected with a virus.  In fact, none
  185. of my discs have ever been infected.  The following files should be in
  186. the !AGP directory:
  187.  
  188. !Boot, !Help, !Run, !RunImage, !Sprites, Default, Help, HelpRdrLib,
  189. HelpReader, HelpTable, Interface, MenuMod, Menus, Messages, Sprites,
  190. Templates, Text
  191.  
  192. You may also find HelpDes and MakeHelp.  If you do, please delete them,
  193. as you don’t need them.  If you find any other files, check !AGP with a
  194. virus killer.
  195.  
  196. History
  197.  
  198. 1.00 (12-Jul-1991)
  199. First released version.
  200.  
  201. 1.01 (16-Jul-1991)
  202. Axis tick marks added.
  203. Caret handling improved.
  204.  
  205. 1.10 (24-Jul-1991)
  206. Layout of Tools window improved and renamed to Controls.
  207. Support for full range of colours added (using ColourTrans).
  208.  
  209. 1.11 (12-Aug-1991)
  210. Window opening made to work better with ZoomBoxer.
  211. More options added to menus.  
  212. Menu handling routines re-written.
  213.  
  214. 1.12 (17-Aug-1991)
  215. Support for new, context-sensitive Helpreader added.
  216.  
  217. 1.20 (18-Aug-1991)
  218. Plotting changed to use Drawing Module.
  219. Printing facility added.
  220. Menu positioning improved.
  221.  
  222. 1.21 (7-Sep-1991)
  223. Controls window re-arranged (again).
  224. Graph window enlarged.
  225. Plotting routines improved.
  226. Menu positioning improved (again).
  227. Position display added.
  228. Error handling improved.
  229.  
  230. 1.22 (18-Sep-1991)
  231. Bug in position display fixed.
  232. Bug in printing routine fixed.
  233.  
  234. 1.23 (20-Sep-1991)
  235. Printing routine improved. 
  236.  
  237. 1.30 (29-Sep-1991)
  238. Saving and loading routines added.
  239.  
  240. 1.31 (1-Oct-1991)
  241. DrawFile saving routines added.
  242. Title window added.
  243.        
  244. 1.32 (2-Oct-1991)
  245. In-RAM transfer support added.
  246.  
  247. 1.33 (4-Oct-1991)
  248. Resolution control added.
  249.  
  250. 1.34 (7-Oct-1991)
  251. Plotting routine improved.
  252. Resolution controls removed from Controls window.
  253. Colour dialogue box improved.
  254.  
  255. 1.35 (10-Oct-1991)
  256. Tick mark positioning algorithm improved.
  257.  
  258. 1.36 (18-Oct-1991)
  259. Accuracy of tick mark routine improved.
  260. Key press handling improved.
  261. Scrolltext added.
  262.  
  263. 1.37 (8-Nov-1991)
  264. Scrolltext speed increased.
  265. Interpretation of power symbols (¹²³) added.
  266. Error handler improved.
  267.  
  268. 1.38 (15-Nov-1991)
  269. Interpretation of ÷ and × symbols added.
  270. Graph resizing added.
  271. Linked Control window added.
  272.  
  273. 1.39 (29-Nov-1991)
  274. Desktop boot saving added.
  275. Error handling improved.
  276. Degrees/radians support added.
  277. Wimp$Scrap checking added.
  278. Grid support added.
  279. Support for dashed lines added.
  280. Dashed lines for off-graph axes added.
  281.  
  282. 1.40 (5-Dec-1991)
  283. Axis scale marks added.
  284. Accuracy of tick mark positioning improved.
  285. Zooming added.
  286.  
  287. 1.41 (6-Dec-1991)
  288. Various minor bugs corrected.
  289.  
  290. 1.50 (21-Jan-1992)
  291. Printing routines improved.
  292. RISC OS compliance improved.
  293. Menu handling altered to work with RISC OS 3.
  294.  
  295. 1.51 (29-Jan-1992)
  296. Help on menus (under RISC OS 3) added.
  297. Bug in plotting routine corrected.
  298.  
  299. 1.52 (31-Jan-1992)
  300. Bug in message handler fixed.
  301.  
  302. 1.53 (14-Feb-1992)
  303. Function parser vastly improved.
  304.  
  305. 1.54 (18-Feb-1992)
  306. Colour storage improved.
  307. Main program crunched.
  308.  
  309. 1.60 (15-Apr-1992)
  310. Hi-res sprite sets and support added.
  311. Bug in error handler fixed.
  312. Contents of title bar of main window altered.
  313. Grid colour made variable.
  314. RISC OS 3 dithering in colour displays added.
  315. Controls window re-designed to lengthen function fields.
  316. Interface Manager updated to version 2.00.
  317. Centring of title, printing and graph windows added.
  318. Re-size drag box limits corrected.
  319.  
  320. 1.61 (2-May-1992)
  321. Faults in templates corrected.
  322. Scrolltext routines improved.
  323.  
  324. Conditions of use:
  325.  
  326. AGP and this manual are Copyright © 1992 Ben Harris.
  327.  
  328. This application may be freely copied and distributed.
  329.  
  330. AGP may not be modified in any way without my prior permission. You may
  331. use any part or whole of this application in any program as long as my
  332. permission is obtained, I am sent a copy of the finished program and I
  333. am fully credited for my contribution in all relevant documentation.
  334.  
  335. If I find that anyone has breached these conditions, they will be
  336. hanged, drawn and quartered (or at least given a stern ticking-off).
  337.  
  338. Thanks to...
  339. Simon Huntingdon        For  his Interface Manager, which handles AGP’s
  340.                         3D effects and pointer shapes.
  341. Ben Summers             For his Helpreader help system and for his help
  342.                         with the intricacies of RISC OS.
  343. David Andrews           For his Menu Manager, which does most of AGP’s
  344.                         menu handling. 
  345. Martyn Spencer          For giving me free use of the Coombe Dean School
  346.                         computer room in the development of AGP.
  347.  
  348. My Address
  349.  
  350. If for any reason you would like to contact me (to report bugs, suggest
  351. improvements, give praise, donate money, etc.), please write to me at:
  352.  
  353. Ben Harris,
  354. 9 Brownhill Lane,
  355. Wembury,
  356. Plymouth,
  357. Devon.
  358. PL9 0JQ
  359.